home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
maximus
/
cidv122.zip
/
CIDLOG.DOC
< prev
next >
Wrap
Text File
|
1992-12-09
|
19KB
|
536 lines
C I D L O G
────────────────────────────────────────────────────────────────────
Program Reference Manual
Copyright (C) 1992 by Steven L. Davis.
ALL RIGHTS RESERVED.
Steven L. Davis SLD Systems,
1143 Washington Green, Building M, New Windsor, NY 12553
(914) 562-1450 / (914)56201722 BBS
CIDLOG v2.22 COPYRIGHT ii
Copyright Notice
CIDLOG is Copyright (c) by Steven L. Davis.
This document is Copyright (c) by Steven L. Davis.
No parts of CIDLOG or this document may be copied in part or in
whole, except as provided in the License at the end of this
document.
Disclaimer
Steven L. Davis and SLD SYSTEMS makes no warranty of any kind,
either express or implied, including but not limited to implied
warranties of merchantability and fitness for a particular purpose,
with respect to this software and accompanying documentation.
IN NO EVENT SHALL STEVEN L. DAVIS OR SLD SYSTEMS BE LIABLE FOR ANY
DAMAGES (INCLUDING DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR OTHER PECUNIARY LOSS)
ARISING OUT OF THE USE OF OR INABILITY TO USE THIS PROGRAM, OR
INFORMATION IN THIS DOCUMENT, EVEN IF STEVEN L. DAVIS OR SLD SYSTEMS
HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
Trademarks
CIDLOG is a trademark of SLD SYSTEMS.
Many product names found throughout this manual are trademarks of
various companies.
CIDLOG V1.22
Caller ID Logging system version 1.22
Caller ID has brought a great resource to the BBS community. And
with the help of this program maximus can take advantage of this
resource. Not only will it log incoming calls, but it will automate
part of the login process, and give the bbs the ability to give
personalized greetings to users, and remove the need for the user to
identify him or her self upon connecting to your system.
The main purpose of this software is to add caller id support to the
maximus BBS system. However it has been written so that parts of
this program could be easily adapted to other bbs systems, as well
as other non BBS uses!
What will it do?
o The CIDLOG(tm) Caller ID LOGGER system will log all calls.
o If you wish, It can allow you to reject callers who BLOCK CALL ID
o IT can identify the user and automate part of the MAXIMUS login.
o It can verify a user without the need for callback verification.
o Will not effect incoming calls from areas without caller ID
What do you need to use this software?
o first off you must have Caller ID service from the phone company.
o you will need either a modified CALLER ID box (Modification adds
a serial interface to the caller id box) or a bell 202 compatible
modem (this may also require a slight modification) more on the
modifications later.
o for this version, you will be required to run a multitasking
system like desqview. No TSR version has been provided here.
The CIDLOG(tm) system consists of the following files:
CIDLOG.EXE - Caller ID Logging program.
CIDFU.EXE - Maximus find user program.
CIDCN.EXE - Used for user verification.
LOGO.MEC - Sample LOGO file, displays users name and
automates the name entry.
CHKPHO.MEC - Sample user verification using CIDCN.EXE
CIDLOG.DOC - This File
LICENSE.DOC - License Info
Program descriptions:
CIDLOG.EXE(tm)
this program monitors the serial port for incoming CALL ID and
maintains 3 files in the current directory:
CALLID.LOG - Logs time date and phone number if incoming calls
NUMBER.DAT - Number of last incoming call
PRIVATE.DAT - File is created if the incoming call has call id
blocked
When a call arrives, CIDLOG.EXE logs the incoming calls to
CALLID.LOG log file. The phone number is also written to NUMBER.DAT
as well over writing any data that may have previously been in that
file (if it doesn't exist then it will be created). If the incoming
call has CALL ID blocked, then the file PRIVATE is created. if the
incoming call DOES NOT have CALL ID blocked, then PRIVATE.DAT is
deleted. sample CALLID.LOG
DATE: 11/22 TIME: 10:30 PH#: (914) 562-1722
DATE: 11/22 TIME: 10:42 PH#: (914) 562-1450
DATE: 11/22 TIME: 11:01 PH#: Out of AREA
DATE: 11/22 TIME: 11:33 PH#: Private
As you can see there is one other possible call type, OUT OF AREA,
which means that the call is coming from an area that doesn't have
caller id service. In the case of this type of call being received
the NUMBER.DAT file will have the text 'Out of Area' in it, and
PRIVATE.DAT will be deleted if it exists.
The Syntax for running CIDLOG is CIDLOG # Where # is the com port
number that your device for receiving caller id data is attached.
For com2: it would started with this command:
CIDLOG 2
CIDMFU.EXE(tm) - Caller ID Maximus Find User. This is the only
maximus specific .EXE file included with this release. CIDMFU(tm)
is designed to be called from maximus from the LOGO.BBS file. it
reads the NUMBER.DAT file created by CIDLOG.EXE and tries to find
the user record for the first record with that number. if the user
record does exist then MAXFU will create 2 files:
USERNAME.DAT - raw name for use in logo screen
POKENAME.DAT - A mecca token file that pokes the users name into
maximus
The POKENAME.DAT file can be linked into the logo file so the logo
screen the user will see can display his name before he enters
anything. The second file is a mecca file which when linked to will
pass the users name to maximus so it is as if the user typed it. (a
sample logo.mec file is included) All the files that are used by
CIDMFU(tm) must be in the current working directory. All files and
created by CIDMFU(tm) are created in the current working directory.
CIDCN.EXE<tm> this file compares the NUMBER.DAT file with a file
written by a mecca file called CHKPHO.DAT, if the phone number in
NUMBER.DAT matches the number in CHKPHO.DAT then a file is created
called PHONEOK.DAT. All files are used by CIDCN must be in the
current working directory. All files and created by CIDCN<tm> are
created in the current working directory.
Initially CIDCN.EXE program was created to use in place of call back
verification, however this program doesn't do any duplicate number
checking in the user.bbs file. if there is sufficient interest,
then I will add this.
The reason for passing the number in a file instead of directly to
the program via a mecca command is that i wanted to give the
flexibility for use in other applications. I.E perhaps checking
against a bad phone number file.
INSTALLATION
FOR MAXIMUS:
Since caller ID comes in between the first and second rings, you
will most likely need to change your configuration. To the best of
my knowledge, maximus picks up only on the first ring, Therefor, you
will need to comment out the RING command in MAX.CTL and set up your
modem to auto answer on the second ring. you can typically do this
by either adding ATS0=2 to your init sequence or programming the
mode m with this parameter and saving it using AT&W command.
Installation is very straight forward. unarc the files, and place
all the .EXE files in your maximus sub directory. Use the sample
logo.mec file to create your new logo screen (you may need to change
the directory names used in the sample logo.mec file). generate
your logo.bbs using the mecca program.
If you want to validate new users then add a link to the CHKPHO.MEC
file from one of the files you display to new users.
Connect your Caller ID receiving device to a free com port.
using your favorite multitasker, run CIDLOG specifying the number of
the com port in the command line.
NON MAXIMUS Installations:
As far as how you will use the programs described above, that is
totally up to you. The CIDLOG.EXE program will log all incoming
calls to a file and the screen. It is a great addition for any
usage, for bbs applications you will need to run CIDLOG.EXE under a
multitasker, so you may also run the bbs. I'm greatly interested in
how people are using this software, so please feel free to drop me a
note or a line and tell me what applications or situations your
using it in!
CALLER ID Reception:
How do I receive caller ID data.
Most of us do not have modems that can receive caller id data.
Caller ID data arrives between the first and second rings. it is
transmitted via BELL 202 type tones, and can be demodulated
(received) using any device that can demodulate these tones (I.E. a
bell 202 style modem or a caller ID box).
We care currently arranging to get inexpensive interfaces for CALLER
ID. However at the moment there are two ways, that I known of, to
receive caller ID to your computer without a special interface or a
special modem.
One fairly easy method is to modify a caller id box, here is an
example of a mod for a standard AT&T model 125 caller ID box which I
use on my own BBS.
NOTE: The following modifications are included in this document for
informational purposes. Use this information at your own risk.
MOD for AT&T Caller id box MODEL 125c
232 Ground
DB25 pin 3
^
--------- | ---------
[|8 7|]---------+ [|1 14|]
| | | | |
[|9 6|] | [|2 13|]
| MC 1488 | | | XR 2211 |
[|10 5|] | [|3 12|]
| | | | |
[|11 4|] +---------[|4 11|]
| | | |
[|12 3|]----> 232 OUT to [|5 10|]
| | DB25 pin 3 | |
[|13 2|]---------+ [|6 9|]
| | | | |
+-[|14 1|]-+ +---------[|7 8|]
| --------- | ---------
| |
+12v -12v
Turn the caller ID box over, with the battery compartment facing
you. remove the 4 screws covering the back of the 125c caller ID
box. Locate the XR2211 chip in the lower right side of the caller
id box. connect pin 7 of the xr2211 to the input of a 232 driver
(pin 2). connect the ground of the xr2211(pin 4) to the ground of
the 232 driver(pin 7) connect the output of the 232 driver to an
RS232 cable (pin 3 on a db25). connect the signal ground of the 232
driver(pin 7) to the signal ground of the rs232 cable (pin 7 on a db
25) apply power to your 232 driver, and that's it.
(USER REPORTED MOD) MOD for a 202 style modem. (authors note: I
have not personally tried this, however it appears to me as it will
work as described to me. I'm looking for comments from anyone who
has tried this or other mods / methods of demodulating caller id
data)
If you can find or have a 4 wire 202 style modem, attach the receive
lines to the incoming phone lines via a .1uf capacitor rated at at
least 300V. (a note for you electronic wizards: this keeps the line
DC isolated so the line will not go off hook when connected to the
modem. WV of the cap needs to be high enough to handle the ring
voltage without arcing )
.1uf
300WV |
T ------------||---------->| Modem incoming
| Receive phone
| Input Line
|
R ------------------------>|
|
We are interested in any additional modifications that might be of
interest to those who wish to capture caller id information, so that
we may pass this information on to others. Please if you have any
additional mods, or comments on these mods, contact us.
Version History:
V1.22 Multitasker Support, Significant improvments to
performance under dos and most multitaskers and networks.
V1.12 Added addidional logging and maximus support
V1.00 Initial release
Who are we?
SLD Systems 1143 Washington Green Building M New Windsor, NY 12553
Providing consulting services for both hardware and software needs.
custom programming and system design.
For a $5.00 US dollars, you can register your version of CIDLOG(tm)
V1.22. Registering your copy of CIDLOG(tm) will help us improve
this software, and entitles you to free updates from our bbs.
Please contact us for additional information on support
arrangements.
Please feel free to leave comments on our BBS on possible updates to
this software. If there is sufficient interest in changes, then we
will include them in a future release of the program.
The author can be reached at:
Steven L. Davis
1143 Washington Green
Building M
New Windsor, NY 12553
VOICE: (914) 562-1450
BBS: (914) 562-1722
Comuserve: 70562,540
Echomail: Maximus ECHO
Fidonet: 1:272/38 (this is not my node, however the sysop of this
node has been kind enough to accept mail for me.)
CIDLOG v1.22 License i
LICENSE
CIDLOG is Copyright (c) 1992 by Steven L. Davis
CIDLOG is not, nor has ever been, public domain or free software.
The commercial, registered version of CIDLOG may not be duplicated
other than for backup purposes. A registered copy of CIDLOG must be
treated like a book, in that the same registered copy of CIDLOG may
not be used in more than one computer at the same time, just as a
book may not be read by more than one person at the same time
(without making an illegal copy).
Users are granted a limited license to use the User Supported, trial
version of CIDLOG for a limited evaluation period of up to 30 days,
in order to determine if it suits their needs. Any other use of
CIDLOG or use past this period requires registration.
All users are granted a limited license to copy the User Supported
version of CIDLOG only for the purpose of allowing others to try it,
subject to the above restrictions as well as these:
CIDLOG must be distributed in absolutely unmodified form,
including ALL program, documentation, and other files.
CIDLOG may not be included with any other product for any reason
whatsoever without a license from Steven L. Davis and SLD Systems.
No charge or payment may be levied or accepted for CIDLOG.
Bulletin Board system operators may post the unregistered, User
Supported version of CIDLOG on their BBS for downloading by their
users without written permission only if the above conditions are
met, and only if no special fee is necessary to access the CIDLOG
files (a general fee to access the BBS is ok).
Distributors of User Supported and Public Domain software MUST
obtain written permission from Steven L. Davis before distributing
CIDLOG and must follow the above conditions. Permission is almost
always granted; this requirement is necessary to ensure protection
for ourselves and CIDLOG users from unscrupulous individuals.
The following section contains information on registration and
licensing.
CIDLOG v2.22 License ii
CIDLOG Ordering/Registration Information
Registering (buying) CIDLOG allows you to use the product after the
trial period.
CIDLOG version 1.22 registration costs $5 US / $6 CDN. A disk with
the current copy of CIDLOG on it is also available for $10 US / $12
CDN. CIDLOG, and includes registration (the right to use CIDLOG
after the evaluation period). The fee covers the cost of
diskette(s) and handling.
Payment may be in the form of check or money order, All US dollar
checks must be drawn on a US bank, and all Canadian dollar checks
must be drawn on a Canadian bank.
Previously regis tered owners of CIDLOG may use the 1.22 evaluation
release at no charge.
Shipping is $2 per copy, to a maximum of $20 in North America, and
$3 per copy to a maximum of $24 outside of North America.
CIDLOG v1.22 License iii
CIDLOG version 1.22 #921209-122
--------------------------------------------------------------------
Remit to: Steven L. Davis,
SLD Systems,
1143 Washington Green
New Windsor, NY 12553
USA
--------------------------------------------------------------------
Quan Item US/CDN Price
___ CIDLOG Registration................ @ $5/$6 ea $________
(registration of Version 1.22)
___ CIDLOG Registration and Disk....... @ $10/$12 ea $________
(includes program on disk + registration)
Disk media type: 5.25" [ ] 3.5" [ ]
Shipping/Handling is: ------------------> Shipping $________
N. America: $2 per disk ($20 max)
Overseas : $3 per disk ($24 max)
Subtotal $________
TOTAL $________
--------------------------------------------------------------------
Payment by: ( ) Check or MO (= ) PO # ____________
Name_______________________________________________________
Company_______________________________________________________
Address_______________________________________________________
_______________________________________________________
Phone(______)________________ Other(______)________________